home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1997 January: Mac OS SDK / Dev.CD Jan 97 SDK2.toast / Development Kits (Disc 2) / OpenDoc Development Framework / Tools & Goodies / ODFx / ODFx Read Me next >
Encoding:
Text File  |  1996-08-26  |  3.1 KB  |  57 lines  |  [TEXT/ttxt]
  1. OpenDoc
  2. Development
  3. Framework
  4.                                                                                                                                                                                      
  5. ODFx Read Me 
  6. ODF Release  2                                                                                                                                                            
  7.  
  8.  
  9. ODFx is a sample part that does multi-colored background images. The Metrowerks Code Warrior PPC project is included for reference.
  10.  
  11. This folder contains:
  12.  
  13.   -  ODFx: The OpenDoc Part. Install this file in your Editors folder
  14.  
  15.         -  Sources: All the non-ODF sources used to build ODFx.
  16.     
  17.         - CWPPCDebug: The Metrowerks Code Warrior PPC project
  18.     
  19.         - ODFx Stationery: Copy this file to your Stationery folder
  20.         
  21.         - Documents: Contains some completely arbitrary samples.
  22.  
  23. -----
  24.  
  25. Brief Instructions:
  26.  
  27. ODFx uses one menu which contains the following menu items:
  28.  
  29. 4 Nodes:
  30. 9 Nodes:
  31. Determine how many colors ODFx uses to create the gradient image.
  32.  
  33. Zone Lines:
  34. Shows or hides lines indicating the boundaries of the color zones in the image. Using 4 Nodes results in 4 zones, 9 nodes results in 9 zones. Double-Click within a color zone to change the color of its corresponding node. Zone Lines appear only on screen -- the lines are not drawn into exported pictures.
  35.  
  36. Chunky Resolution:
  37. Good Resolution:
  38. Fine Resolution: 
  39. Determines the number of interpolation steps between colors. Chunky uses 64 steps. Good uses 128 steps. Fine uses 256 steps. Calculating the image at Fine resolution can take a few seconds, even on a Power Macintosh, and the results are worth the time and memory usage only if the resulting image will cover a large area. The default resolution is "Good."
  40.  
  41. Rotate Colors:
  42. Rotates the color nodes clockwise. In the 9 Node image, the center does not move.
  43.  
  44. -----
  45.  
  46. Miscellaneous Notes:
  47.  
  48. ODFx supports drag and drop.
  49.  
  50. ODFx generates a 24-bit offscreen image (using FW_CBitmap) and uses the FW_CColor::Blend() method to interpolate the colors for the image. It then creates a picture (FW_CPicture) of this image, and draws it to the screen. The dimensions of the internal image depend on the number of interpolation steps. 64 steps yields a 64x64 pixel image, and 256 steps yields a 256x256 pixel image. The resulting picture is cached, and is updated only when the parameters change, so once the image is calculated, updates are much faster. The picture is created using dithering, so it may be scaled to any desired size. There is no indication when the image is being recalculated, and for the "Fine" resolution images, the drawing may take a few seconds. There's not always a big difference between Good and Fine: use Fine prudently.
  51.  
  52. When an ODFx image is copied or exported, it will appear as a small square picture which can be scaled.
  53.  
  54. Other than the usage of the ditherCopy transfer mode when creating the FW_CPicture, this code should be cross platform.
  55.  
  56. © 1993 - 1996 Apple Computer, Inc. All rights reserved.
  57. Apple, the Apple Logo, Macintosh, and OpenDoc are trademarks of Apple Computer, Inc., registered in the United States and other countries.